Important Information

Introduction
The 1.1 update is a free update to Z-Write 1.0. Installing Z-Write 1.1 will not affect your registration or non-registration of Z-Write 1.0 in any way. (If your old version of Z-Write expired, this version will also be expired.)

There have been significant changes to Z-Write for this update. On-line documentation and the PDF manual have not been updated yet, so it is highly recommended that you read this document to understand the changes and learn about the new features.

Installing Z-Write 1.1
Z-Write 1.1 is available in two versions: an update or a complete package. If you have the complete package, simply replace your old Z-Write folder with the new one. (Note: if you saved any documents within the Z-Write folder, be sure not to throw them away!)

If you have downloaded the smaller update package, you’ll need to run the “Z-Write 1.1 Patch” application which will convert your Z-Write 1.0.x to Z-Write 1.1. Then you can simply move the other elements included with the update into your Z-Write folder (replacing the old items). Be sure you place the new “Templates” folder inside your Z-Write folder (see the new Default Template system described later in the document for more).

New Document Structure/Preferences
Z-Write 1.1 uses new Preference settings and stores some new information within your Z-Write documents, it is not wise to mix the two versions. While 1.0 will open 1.1 documents just fine, it will lose the new information saved by 1.1, both in the document and within Preferences. This is not fatal by any means, but it could cause confusion.

New FAQs (Frequently Asked Questions)
STS has posted two Z-Write FAQ documents on our website. We will update these as needed. Please check them first if you have questions or problems with Z-Write.

   <http://www.designwrite.com/sts/support.html>

New Features for 1.1

Hypertext
Z-Write now features a hypertext system which allows you to insert special tags into your document. Command-clicking on these tags takes you to the indicated Section. When you print or export, these tags are removed. When you export to HTML, these tags are converted to standard HTML hypertextual links (the name of the Section is “hot”).

The tag format is like this:  <link sectionname>

When you Command-click a selected tag (Command-click at the beginning of the tag [at the "<" character] to select it automatically), you are immediately taken to the Section indicated. If the Section doesn't exist, nothing happens.

You may insert a link by dragging a Section name from the Section List into your document or by using the new Command-L "Insert Link" command.

Section Insertion
This is a unique and powerful feature that's so new I haven't really figured out everything it's capable of doing. Currently it's at 1.0 functionality -- there's room for improvement.

Basically it's very similar to the above Link feature, except instead of linking, it inserts one Section into another. For instance, if you had a Z-Write document with 26 Sections, each with the name of a letter of the alphabet, putting <insert B> into Section A would cause the entire text of B to be inserted at that point inside A, when you export or print.

I originally envisioned this as a simple way to create your own document structure. For instance, the above document could have another Section called "Alphabet" and include a series of <insert A>, <insert B>, <insert C>, etc. down to Z. If you wanted to, you could have multiple versions of "Alphabet" one with just part of the alphabet, one with just the vowels, etc. This way, instead of having to specify which Sections to combine for printing, you could have a set already defined and ready to print. (You also have completely control over how the Sections are separated.)

One potential problem with this feature is that it could easily be abused: for instance, what happens if you put in an <insert A> _within_ Section A? Or how about Section A includes Section B and Section B includes Section A... you get the idea. At this time, Z-Write does not support such "nested" inclusions. I may in the future, depending on interest (and if someone can show me a benefit). What happens now is Z-Write will do the first insertion, then ignore subsequent ones (the tags are simply deleted).

Just like Links, you may Command-click on an Insert to jump to that Section. You may insert an Insert tag by dragging a Section name from the Section List into your document while holding down the Option key, using the new Command-L "Insert Link" command, or type it in by hand.

Glossary Auto-expansion
Now when you type a glossary item name, Z-Write will expand it automatically when you type a space or end-of-sentence character (return, quote mark, hyphen, punctuation, etc.). There's a new Preference setting to turn this off. If you don't want Z-Write to expand the item, type Shift-Space or Shift-Return.

New Keyboard Navigational Commands
I've added a bunch of new navigational commands. Z-Write 1.1 supports the following:

Deleting:
  [delete] - Deletes next character on the left or the selection
  [shift-delete] - Deletes character to the right or the selection
  [option-delete] - Deletes word to the left
  [shift-option-delete] - Deletes word to the right

Movement:
  [left/right arrow] - Moves cursor left/right one character
  [up/down arrow] - Moves cursor up/down one line
  [option up/down arrow] - Switches to next Section up/down
  [option left/right arrow] - Moves one word left/right
  [control left/right arrow] - Moves to next/previous paragraph
  [control up/down arrow] - Jumps to beginning/end of doc

When the above keys are used in conjuction with the Shift key, the text is selected (or the existing selection is extended).

Toggle Sections
You can now jump between the current Section and the last Section you were in by pressing the Escape key. Pressing it a second time takes you back to the original Section.

Hide Section List
You can now hide the Section List by clicking (one click) on the Move Bar (the drag bar between the Section List and the editing area). This will shift the Move Bar to the far left, giving you the entire window for writing. Click the Move Bar again to bring the Section List back.

You can still move between Sections even when the Section List is hidden, by using the Option-Up/Down arrow keyboard commands, or pressing the Escape key to toggle between two Sections.

Import Folder
There's a new command on the File menu called "Import Folder" which prompts you to select a folder. It then imports in all text files in the root of that folder (it does not go below the root level of that folder). If it's a text file it brings it in as blank text, formatted with your default font and size; if it's a Simpletext file, it brings it in with all formatting intact.

Each file is made into a Section, with the Section name being set to the name of the file.

Important: if you choose Import Folder while you have a document open, the files are added to the current document. If you choose the command when no files are open, the files are added into a brand-new untitled document.

Import File
This works just like Import Folder except with a single file. Mostly useful it you want to add a text file as a Section to the current document. 

Revert to Saved
You can now Revert to the last saved version of your file (essentially this just closes the file without saving and reopens it).

Features Enhanced for 1.1

New “Section Tools” Menu
The Section commands -- Add Section, Duplicate Section, Remove Section, etc. have been moved to their own menu. This makes more sense and shortens the overlong Utilities menu.

Rearrange Sections Dialog
This dialog has been significantly enhanced. There are two new buttons, "Move to Top" and "Move to Bottom" which move the selected Sections to the top or bottom of the list. Most important, you can now select more than one line at a time. Hold down the Shift key to select items contiguously; hold down Command to select items discontiguously.

Also, the up/down arrow keys move the selected items up or down one row. Option-up/down arrow moves the selected items to the top or bottom of the list.

HTML Export
I have completely rewritten the HTML Export routine -- it is now at least 5 times faster, and offers some new feature as well:

  - Text sizes are preserved.
  - URLs and e-mail addresses are automatically made "hot."
  - Link tags (as mentioned above) convert to HTML links when
    you use the multiple file option. (If you use the single file
    option, they are simply deleted.)
  - HTML settings are now stored within each Z-Write document.
  - <C> tags now convert to <CENTER> tags.
  - <N> tags convert to <HR> tags.
  - You can specify the creator type of the HTML files
    generated (within the new HTML panel within the Preferences
    dialog).
  - Fixed several HTML Export bugs.

Text Conversion
I have added several text conversion features, such as "Returns to Double Returns," "Double Returns to Returns," "Form Paragraphs," and "Remove Line Feeds." These are available on the Convert submenu on the Utilities menu.

Preferences
Items have been rearranged a bit, and there is a new HTML panel. Two new prefs have been added: the Auto-Expand Glossary Items and the Specify HTML Creator Type.

The “Choose Template” button has been removed from the “On Launch” area as well as the “Open Template on Launch” option, as Z-Write now uses a different method for setting the Default Template (see below).

Revised Template System
Z-Write 1.1 includes a new Templates folder. Inside this folder is a document named “Default Template.” When you create a new, untitled blank document, Z-Write will automatically open a copy of the “Default Template” document, using whatever settings are in that file. For instance, if you wish new Z-Write documents to open with a larger window size, simply open the “Default Template,” make the window bigger, save it, and quit Z-Write. The next time you create a new document in Z-Write, it will use the larger window size.

If you don't want Z-Write to use the “Default Template” document, simply move, rename, or delete it. Z-Write will only use a file named (exactly) “Default Template” that's stored inside the “Templates” folder that's inside the Z-Write folder.

Power User Prefs
This is a new system that allows you to customize Z-Write. It's designed for “power users,” as these settings don't have a user interface to allow you to tweak them. See the separate “Power User Prefs” document for more information on how to work with these.

Bug Fixes and Minor Enhancements

- Made it so adding a new Section adds it after the current
  Section (instead of at the end of the List)

- Added a menu command for "Open Section as View Window"

- Word count routine is more accurate

- Changed "Check Spelling" command key to Command-Shift-L

- You can now drag Section names to Duplicate or Trash buttons

- Size button on Button Bar now says "Other" when type is set
  to a non-standard size

- Resizing text in Help is much faster (instant)

- Newly opened files now reflect a “saved” state (instead of “unsaved”)

- Made it so Check Spelling won't crash if Excalibur can't be found

- Fixed "Find Again" bug that made it not work if the search
  string was already selected

- Replace All for the current Section is now undoable. (To undo a
  Replace All for all Sections, simply save your document before
  replacing and then Revert the file.)

- Moved “Instructions” help item to the Apple Menu (under
  “Registration Info....” to compensate for REALbasic conflict
  with Palm Instant Desktop.

- Z-Write will now convert accent characters in Section names to
  proper HTML equivalents when you export to HTML. It will also
  convert accented characters to non-accented characters
  for the filenames used when you export linked files.

Known Issues

Z-Write 1.1 has been tested and proved stable, but there have been reports of memory problems where quitting Z-Write causes the Finder to quit or crash. This only happens on certain system configurations and STS is working to discover the source of the problem. If you are having this problem, please see the Z-Write Troubleshooting FAQ on our website for the latest information and solutions.

   <http://www.designwrite.com/sts/faqs/z-write_troubleshooting.html>

Marc Zeedar
Stone Table Software
sts@designwrite.com